<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.0 Transitional//EN">
<HTML>
<HEAD><meta http-equiv="Content-Type" content="text/html; charset=iso-8859-1">
<title>File System Providers</title>
<style type="text/css">@import url("file:/home/moovida/rcpdevelopment/eclipse/configuration/org.eclipse.osgi/bundles/488/1/.cp/book.css");</style>
<style type="text/css">@import url("file:/home/moovida/rcpdevelopment/eclipse/configuration/org.eclipse.osgi/bundles/505/1/.cp/schema.css");</style>
</HEAD>
<BODY>
<H1 style="text-align:center">File System Providers</H1>
<p></p>
<h6 class="CaptionFigColumn SchemaHeader">Identifier: </h6>org.eclipse.core.filesystem.filesystems<p></p>
<h6 class="CaptionFigColumn SchemaHeader">Since: </h6>org.eclipse.core.filesystem 1.0
<p></p>

<h6 class="CaptionFigColumn SchemaHeader">Description: </h6>This extension point is used to provide implementations of the abstract file system API org.eclipse.core.filesystem.IFileSystem.  File system implementations control all aspects of querying and modifying a tree of files and directories in some backing store.  Each file system extension is responsible for a file system namespace identified by a particular URI scheme.<p></p>
<h6 class="CaptionFigColumn SchemaHeader">Configuration Markup:</h6>
<p></p>
<p class="code SchemaDtd">&lt;!ELEMENT <a name="e.extension">extension</a> (<a href="#e.filesystem">filesystem</a>)&gt;</p>
<p class="code SchemaDtd">&lt;!ATTLIST extension</p>
<p class="code SchemaDtdAttlist">point&nbsp;CDATA #REQUIRED</p><p class="code SchemaDtdAttlist">id&nbsp;&nbsp;&nbsp;&nbsp;CDATA #IMPLIED</p><p class="code SchemaDtdAttlist">name&nbsp;&nbsp;CDATA #IMPLIED</p>&gt;</p>
<p></p>
<ul class="ConfigMarkupAttlistDesc">
</ul>
<br><p class="code SchemaDtd">&lt;!ELEMENT <a name="e.filesystem">filesystem</a> (<a href="#e.run">run</a>)&gt;</p>
<p class="code SchemaDtd">&lt;!ATTLIST filesystem</p>
<p class="code SchemaDtdAttlist">scheme&nbsp;CDATA #REQUIRED</p>&gt;</p>
<p></p>
<ul class="ConfigMarkupAttlistDesc">
<li><b>scheme</b> - The URI scheme of this kind of file system.</li>
</ul>
<br><p class="code SchemaDtd">&lt;!ELEMENT <a name="e.run">run</a> EMPTY&gt;</p>
<p class="code SchemaDtd">&lt;!ATTLIST run</p>
<p class="code SchemaDtdAttlist">class&nbsp;CDATA #REQUIRED</p>&gt;</p>
<p></p>
<ul class="ConfigMarkupAttlistDesc">
<li><b>class</b> - The fully qualified name of a class that subclasses org.eclipse.core.filesystem.provider.FileSystem</li>
</ul>
<br><h6 class="CaptionFigColumn SchemaHeader">Examples: </h6>Following is an example of a file system extension that provides access
to file systems using the "gopher" URI scheme.

<p>
<pre class="Example"><span class="code SchemaTag"> 
   &lt;extension id=</span><span class="code SchemaCstring">&quot;gopherFS&quot;</span><span class="code SchemaTag"> name=</span><span class="code SchemaCstring">&quot;Gopher File System&quot;</span><span class="code SchemaTag"> point=</span><span class="code SchemaCstring">&quot;org.eclipse.core.filesystem.filesystems&quot;</span><span class="code SchemaTag">&gt; 
       &lt;filesystem scheme=</span><span class="code SchemaCstring">&quot;gopher&quot;</span><span class="code SchemaTag">&gt;
           &lt;run class=</span><span class="code SchemaCstring">&quot;com.xyz.fs.GopherFileSystem&quot;</span><span class="code SchemaTag">/&gt; 
       &lt;/filesystem&gt; 
   &lt;/extension&gt;
</span></pre>
</p>

If this extension was defined in a plug-in with id "com.xyz.coolplugin", the fully qualified name 
of this file system extension would be "com.xyz.coolplugin.gopherFS".
<p></p>

<h6 class="CaptionFigColumn SchemaHeader">API Information: </h6>The value of the class attribute must represent a 
subclass of 
<samp>org.eclipse.core.filesystem.provider.FileSystem</samp>.
<p>
File system instances can be obtained via the method
<samp>org.eclipse.core.filesystem.FileSystemCore.getFileSystem(String)</samp>.
<p></p>

<h6 class="CaptionFigColumn SchemaHeader">Supplied Implementation: </h6>The platform provides a file system implementation for the "file" scheme.
<p></p>

<br>
<p class="note SchemaCopyright">
Copyright (c) 2005 IBM Corporation and others.<br>
All rights reserved. This program and the accompanying materials are made 
available under the terms of the Eclipse Public License v1.0 which 
accompanies this distribution, and is available at 
<a href="http://www.eclipse.org/legal/epl-v10.html">http://www.eclipse.org/legal/epl-v10.html</a>

</p>
</BODY>
</HTML>
